home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_misc / raptr9b4.zip / RAPUPD.DOC < prev    next >
Text File  |  1996-06-22  |  50KB  |  1,025 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                        RAPTOR BBS - Undocumented Commands
  8.                        (c) 1995, 1996 by The Raptor Development Team
  9.                        All Rights Reserved
  10.  
  11.  
  12.  
  13. (6-28-95)
  14. The following additions and changes to RAPTOR have been made and are not
  15. at this time included in the document files.
  16.  
  17. Multinode
  18. ---------
  19.         RAPTOR BBS will now support up to 256 nodes under DesqView, OS/2
  20.         or other multitaskers. To configure the information for each
  21.         node.
  22.         (1) Start RAPTOR with the standard BBS.EXE.
  23.         (2) From the WFC screen select <P> for system configuration,
  24.         <A> for modem/node configuration then <A> for node  number.
  25.         (3) Enter the node number for the node you wish to configure,
  26.         then proceed to enter the other information requested on the
  27.         screen.
  28.         (4) Return to the WFC screen after completeing all node
  29.         information.
  30.         (5) Repeat steps (2) through (4) for any other nodes. This will
  31.         create the MODEM###.DAT file for each node.
  32.         (6) Start each node with the command line BBS -n### where ### is
  33.         the node number. If you use BBS without the -n### parameter
  34.         RAPTOR will default to node 1.
  35.  
  36.         A new MCI code has been added to the doors MCI codes. %M will
  37.         now pass the current Node number as a parameter to the command
  38.         line in ONLINE.MNU.
  39.         An MString of DOOR.BAT %M called from node 2 will then pass
  40.         DOOR.BAT 2.
  41.  
  42.         A new MCI has also been added that can be used in files,
  43.         prompts, and the string editor. An MCI of %E will display the
  44.         current node number in the form 'NODE ###' where ### is the
  45.         current node number.
  46.  
  47.         SysOp logs also now show the node number which the user is
  48.         logged in on.
  49.  
  50.  
  51. Conferences
  52. -----------
  53.         RAPTOR now supports up to 26 conferences for message and file
  54.         areas designated A to Z. All conferences are configurable with
  55.         an ACS string to limit access to certain areas of the BBS. To
  56.         assign a file or message are to a conference use the Cx ACS
  57.         command in the area's ACS string, where x is the conference
  58.         identifier. In other words an ACS string with the commands
  59.         S100CD means Security level 100 and joined to conference D. The
  60.         new menu Command Key to 'Join Conference' is OJ. If the MString
  61.         for this command is left blank it will prompt the user for the
  62.         conference they wish to join with an option to list the
  63.         conferences. If the MString contains a valid conference
  64.         Identifier then the OJ command will change the user to that
  65.         conference. If the user is restricted from a conference by the
  66.         conference ACS string they will not see that conference listed
  67.         and will not be able to join that conference.
  68.  
  69.         The conference Editor is accessible from the WFC screen using
  70.         the "$". The options in the editor are fairly straight forward
  71.         to Insert a new conference, Modify an existing conference, or
  72.         Delete an existing conference.
  73.  
  74.        (* Raptor will start using conference 'A' for each login, even
  75.         though this conference has not been defined.
  76.         The conference system allows you to make groups of message areas
  77.         or file areas available to only users with certain security
  78.         settings. *)
  79.         This was changed in the .8 beta series to record the last
  80.         conference the user was in. 'A' will be used for new users.
  81.  
  82.  
  83. Network Addresses
  84. -----------------
  85.         The addresses set up in the Network configuration are now used
  86.         to configure the addresses in echomail message areas as well as
  87.         in processing netmail by the RAPMAIL program. When you select
  88.         the option to configure the network address of a message base
  89.         you will see the list of addresses displayed and be prompted for
  90.         which you wish to use.
  91.  
  92. ============
  93. <07-04-95>
  94. ============
  95.  
  96. Nonstandard Comports
  97. ---------------------
  98.         Support for nonstandard IRQ's and Com Base addresses are
  99.         supplied to RAPTOR through the fossil driver. However DSZ/GSZ
  100.         and some other transfer protocols are interrupt driven and the
  101.         fossil is unloaded by RAPTOR as it shells to the external
  102.         protocol. In order for the protocol to handle the nonstandard
  103.         port cofiguration it is necessary to pass the IRQ and base
  104.         address of the comport to the protocol program. RAPTOR now
  105.         allows you to configure the IRQ and Address of the port in the
  106.         MODEM configuration menu from the MFC screen. These are passed
  107.         to the protocol in the variable %I ( IRQ from modem congig) and
  108.         %A ( base address from modem config). Refer to the documentation
  109.         for the protocol driver you are using for the correct syntax to
  110.         pass these variables to the protocol. You must then edit the
  111.         protocol commandline in the PROTOCOL EDITOR from the WFC.
  112.  
  113. ========
  114. 07-08-95
  115. ========
  116.  
  117. Mail processing
  118. ----------------
  119.         RAPTOR will exit with an errorlevel of 2 to DOS if there is new
  120.         echomail or netmail. This will allow you to process mail only if
  121.         there is new mail ( Yeah I know.... RAPMAIL is to ^$#&$* slow
  122.         when the message bases get big... working on it <G>) instead of
  123.         after every caller.
  124.          The command line would look something like
  125.          If errorlevel = 2 then goto newmail
  126.          Goto Nomail
  127.          :Newmail
  128.          RAPMAIL -s
  129.          REM  Enter command sfor the processor here GEcho FMail etc.
  130.          RAPMAIL -P
  131.          GOTO END
  132.          :NOMAIL
  133.          GOTO END
  134.  
  135. ==========
  136. 07-11-95
  137. ==========
  138.  
  139. RAPMAIL Scanning
  140. ------------------
  141.         RAPMAIL will now only scan the netmail directory and any echo
  142.         areas with NEW messages. The purge will check all directories,
  143.         if a .MSG or HIWATER.MRK file exists in that directory then it
  144.         will be purged and the PURGING COMPLETE message displayed, or
  145.         else the NO MESSAGES message will be displayed. This makes
  146.         RAPMAIL much faster in normal operation. There is no change in
  147.         the Toss operation.
  148.  
  149. ==========
  150. 07/16/95
  151. ==========
  152.  
  153. Logoff Quotes
  154. -------------
  155.         Logoff quotes are now available to the users. To enable Logoff
  156.         Quotes a new menu command "OQ" has been added. "OQ" will prompt
  157.         the user if they wish to leave a logoff quote and allow them to
  158.         enter a one line 78 character quote. There is NO MString for the
  159.         "OQ" command, and the acs string may be set to restrict the
  160.         users who have access to leave a quote. If you have 'AutoMessage
  161.         in Logon' enabled inthe BBS setup the last logoff quote will be
  162.         shown to the user in the form
  163.         "(USERNAME) was logged in recently and said.."
  164.         " <QUOTE>"
  165.         Colors may be used in the quote line using the standard CTRL-P
  166.         selections. If no color codes are used the quote will be in
  167.         Yellow. The first line will be in Blue.
  168.         The "OR" Command keys has also been added to allow users to read
  169.         back through the logof quote file one screen at a time. "OR" has
  170.         no MString for the command.
  171.  
  172. Readmail commands
  173. -----------------
  174.         The read e-mail submenu commands have been changed to make them
  175.         a bit more standard. To reread the last message use "A" for
  176.         Again, and to reply use the "R" command. (*Public and Echomail
  177.         currently still uses the "A" autoreply command... working on
  178.         that one watch this space for future changes<G>*)
  179.  
  180.      **** All public and private messages now use 'A' to read again and
  181.      'R' to reply.*****
  182.  
  183. =============
  184. 08-15-95
  185. =============
  186.  
  187. Expanded RIP features
  188. ---------------------
  189.         The RIP support for your users is still being updated.Mouseable
  190.         pop-up picklists for File Areas, Message Ares, and Conferences
  191.         is in place. The RIP background wallpaper behind the lists is
  192.         configurable. RAPTOR will look for a .RIP file for each area
  193.         WPMSG.RIP for messages
  194.         WPFILE.RIP for files
  195.         WPCONF.RIP for conferences
  196.         and display this file as the background for the pop-up lists.
  197.        If the file does not exist RAPTOR will display it's own internal
  198.        wallpaper. These files must be stored in the AFILES directory. It
  199.        is recommended that theses screens contain no mouse areas, and
  200.        that after creating these files you use a text editor to remove
  201.        the |#|#|# (RIP_no_more) command from the end of the file. The
  202.        editor RIP control panel and the file browse control panel and
  203.        RIP login prompts are all internal to RAPTOR and will be
  204.        configurable in future releases through the RIP cfg options to be
  205.        added, but will not be editable.
  206.  
  207. External Full Screen Editor
  208. ----------------------------
  209.         Although RAPTOR includes a very powerful internal editor, it
  210.         still has the drawback of being a line based editor. Since many
  211.         users prefer the ease of using a full screen ANSI editor we have
  212.         included support for RemoteAccess (RA (c) Wantree Development
  213.         and Andrew Milner) style full screen external editor. We have so
  214.         far tested this feature with the shareware editor IceEdit ((c)
  215.         Jeremy        ). A new option (X) has been added to the  system
  216.         configuration menu to configure the external editor. Options
  217.         here are
  218.         A. Use external editor
  219.         B. Editor dropfile type
  220.         C. Editor command line
  221.         A). This is a yes/no toggleable field which enables use of an
  222.         external editor. If this is set to NO then RAPTOR will not
  223.         attempt to use an external editor.
  224.         B) This is the drop file tpye needed by your external editor.
  225.         When you select B you will be presented with a list of possible
  226.         drop file types and their corresponding key letter. For IceEdit
  227.         we selected type 'D' - Dorinfox.def. Selecting '-' will not
  228.         create a drop file allowing you to pass the values required by
  229.         your editor to it on the command line using the standard RAPTOR
  230.         Door information MCI codes.
  231.         C) This is the command line required to start your editor. In
  232.         configuring IceEdit we entered a command line of:
  233.         EDIT.BAT %M
  234.            ^      ^
  235.            |      |_____Passes current node number for this node
  236.            |           (i.e.  Node 1 would pass 1)
  237.            |
  238.            |________Batch file to launch your editor
  239.         Our EDIT.BAT was really pretty simple
  240.         CD\ICEEDIT
  241.         ICEEDIT /D:C:\RAPTOR\TEMP\N%1
  242.         CD\RAPTOR
  243.         The /D: switch in the ICEEDIT parameter passes the directory to
  244.         look for the drop files to the door (DORINFOx.DEF and MSGTMP).
  245.         The %1 batch variable passes the current node number from the %M
  246.         MCI code making the N%1 come out as N1 ( default directory for
  247.         node 1 from the Modem config setup)
  248.         In order to properly configure an external editor you must
  249.         understand a bit about how RAPTOR handles messages. If you are
  250.         replying to a message RAPTOR creates a file called MSGTMP and
  251.         stores it in the node drop file directory for the current node.
  252.         This directory is configured in the modem setup option from the
  253.         system configuration menu of the WFC. MSGTEMP is a file which
  254.         contains the text of the message you are replying to. This file
  255.         is used by RAPTOR's internal editor as the quotable part of the
  256.         text, and is also used by RA compatible editors as their quote
  257.         files. It is necessary to point the editor to the proper
  258.         directory where it can find MSGTMP. In this case both the
  259.         Dorinfox.def file and MSGTMP are located in the same directory,
  260.         and ICEEDIT assumes they will be found together, so the /D:
  261.         switch points ICEEDIT to the proper directory for both it's drop
  262.         file and the MSGTMP quote file. ICEEDIT will rewrite the MSGTMP
  263.         file to include the selected quoted text as well as the text of
  264.         the new part of your message. If you abort the message in
  265.         ICEEDIT the MSGTMP file will be erased. If RAPTOR returns from
  266.         the external editor and MSGTMP does not exist it will assume the
  267.         message has been aborted. If MSGTMP exists RAPTOR will then
  268.         import the text into the mesage base. It is not necessary to
  269.         enter the To and subject information in the editor, only the
  270.         message body text.
  271.         That, in a nutshell, is how to install your external editor. As
  272.         with all shareware products, please register any shareware
  273.         editor you may select.
  274.         If a user is in either the external OR internal editor it is not
  275.         possible to do an on-line adjustment of their account status
  276.         using the F1 key.
  277.  
  278. Other stuff
  279. -----------
  280.         Although the recent dates of the additions to this file make it
  281.         look as if we have been sitting on our backsides for a couple
  282.         weeks that isn't exactly true. Many changes have been begun
  283.         internally for added features and options. In the near future we
  284.         will see the ability to attach files to E-Mail, configure the
  285.         look of on-the-fly RIP screens, have your default RIP menus
  286.         updated automatically whenever you change your .MNU files, and
  287.         hopefully the addition of on-the-fly light bar menus for your
  288.         ANSI users.
  289.  
  290. ============
  291.   8-17-95
  292. ============
  293.  
  294.  Automatic updating of default RIPs
  295.  ----------------------------------
  296.         Ok as mentioned above some of the near future has arrived. The
  297.         default RIP menus are now generated whenever a RIP caller logs
  298.         on. The screens will show only the commands the user has access
  299.         to. To control the function of the updater a new switch has been
  300.         added to the system config <H> Miscelaneous  menu. That option is
  301.         'Use default RIP menus'. If this is set to ON then RAPTOR will
  302.         regenerate a new RIP menu anytime you change the .MNU file. If the
  303.         menu is all first commands there will be no RIP screen generated.
  304.  
  305.   >>*<<  >>*<<  >>*<<  >>*<<  >>*<<  >>*<<  >>*<< >>*<<
  306.   IMPORTANT!!!
  307.        If you use custom RIP screens be certain to set the option to use
  308.        default RIP menus to OFF! If this option is enabled your custom
  309.        screens will be overwritten by the default menus!
  310.   >>*<<  >>*<<  >>*<<  >>*<<  >>*<<  >>*<<  >>*<<  >>*<<
  311.  
  312.         Configuration for colors and text styles in a future release
  313.         will be added shortly... RIP menus will also accept only 48
  314.         commands, in other words command #49 and #50 will NOT be shown
  315.         on the default RIPS. Of course if you have that many commands on
  316.         one menu it is probably long past time to create a submenu <G>
  317.  
  318.  
  319. ===========
  320.   8-28-95
  321. ===========
  322.    Split screen chat
  323.    -----------------
  324.        With the Version 06a2 release RAPTOR introduces the concept of
  325.        external software modules. Modules allow 3rd arty developers to
  326.        write RAPTOR specific utilities whic can run as an external
  327.        program, and have RAPTOR pass the necessary information to the
  328.        Module in a standard format. Some of the parameters are still
  329.        under development, however we introduce our first Module with
  330.        this the release, the Split Screen Chat Module. The module is
  331.        contained in the file CHATMOD.EXE, and unlike door style chat
  332.        programs require absolutely NO SysOp configuration. In addition
  333.        thrid party authors can develop a split screen chat module which
  334.        SHOULD require no configuration on the sysop's part. Provided the
  335.        executable is called CHATMOD.EXE this file can be copied into the
  336.        Main RAPTOR BBS directory and run exactly as the Development team
  337.        supplied module. Split screen chat may be accessed with the ALT-C
  338.        key combination and the standard line by line chat is still
  339.        accessed by the F-10 keys.
  340.  
  341.     The Module Concept
  342.     ------------------
  343.         The module concept allows third party developers to write addin
  344.         programs or modules which can be run seamlessly from RAPTOR and
  345.         require little or no SysOp installation.
  346.         In order to qualify as a module a program must meet these
  347.         requirements.
  348.         1) Modules will NOT make use of any form of drop file  other
  349.         than those created by RAPTOR when the 'Launch Module' command is
  350.         called.
  351.         2) Modules must read the RATOR files necessary to locate
  352.         directories as described in the RAPTOR Development Kit. In other
  353.         words, if the Module requires access to one or more of RAPTORS
  354.         Message or File Bases the module must read the RAPTOR STATUS.DAT
  355.         file and the other appropriate files to locate the path to the
  356.         files, and may use external configuration files ONLY for
  357.         information not supplied by RAPTOR.
  358.         3) The Module must detect the fossil used by RAPTOR
  359.         automatically, and handle initializing the fossil if using
  360.         Fossil IO or make certain that it can use it's own onternal comm
  361.         routines. It must NOT be up to the sysop to configur comm
  362.         information.
  363.         4) The module must contain file locking routines or be clearly
  364.         marked for SINGLE NODE USE ONLY.
  365.         5) The module should only modify files created by RAPTOR for
  366.         module purposes only. It should modify RAPTOR'S data files
  367.         directly ONLY if the information needed is not available through
  368.         the rereadable module data file.
  369.    ***NOTE***
  370.         The final format of the Module Data File has not been completely
  371.         finalized. The final spec for this will be available shortly.
  372.         For up to the minute information about what is included in the
  373.         information available to modules contact the Development Team.
  374.  
  375.         In addition, in order for a module to be considered "approved"
  376.         it should meet the following crieria:
  377.         1) If the module is shareware then the registration fee should
  378.         be reasonable when compared to the priceof RAPTOR. In other
  379.         words a $40.00 file handler for a $60.00 BBS is not considered
  380.         reasonable <G>. The development team will make every effort to
  381.         supply basic utilities and modules that are not internal to
  382.         RAPTOR available to sysops at a free or EXTREMELY inexpensive
  383.         rate.
  384.         2) When unregistered the module may have features disabled but
  385.         must present a true representation of the modules MIAN function.
  386.         Nags are permitted either at the beginning of the module or the
  387.         end, but NOT both, and the nag should NOT exceed 15 seconds in
  388.         length. This area should also include any author/copyright info,
  389.         again at the beginning or end, not both.
  390.         3) By accepting a module for 'approved ' status, the development
  391.         team does not gharantee that any one module will get exclusive
  392.         rights to 'approved'stsus for that type of module, nor that we
  393.         will not at some future date include similar features either
  394.         internally or in the form of a free module. IOW if you write a
  395.         killer QWK module, we may still release a basic QWK module.
  396.         4) The author of approved modules must subscribe or have access
  397.         to a BBS that does subscribe to one of the current RAPTOR
  398.         support echos( as of now NVR_NET and SAC_NET). We will not
  399.         support your product! Also the development team must have a
  400.         current voice phone number to contact the author of any approved
  401.         modules. Failure to provide support on a reasonable basis will
  402.         be reason to drop a products 'approved' status.
  403.         5) Continued acceptance of a product as approved is entirely up
  404.         to the discretion of the development team. Any product may be
  405.         dropped from the approved list at any time for any reason.
  406.  
  407.         Although some of these requirements may sound a bit restrictive,
  408.         their basic purpose is in keeping with The Development Teams
  409.         basic mission statement. To provide the BEST possible online
  410.         Host system to system operator, for the best price possible,
  411.         requiring the least amount of configuration possible, while
  412.         maintaining maximum flexibility. While we are not attempting to
  413.         tell anyone how to write his/her program, or how to price or
  414.         market his/her program, these requirements are presented only as
  415.         guidelines for the things we will evaluate before adding a
  416.         module to the approved list. Certain approved products may be
  417.         included with releases of RAPTOR, in their shareware form.
  418.         Shareware products submitted for evaluation to be included as
  419.         approved should include both a shareware and a registered
  420.         version.
  421.  
  422. 11-15-95
  423. ========
  424. Ver 0.7a1
  425.    OK well it's been a while since we worked on this doc, but here is
  426.    the latest. A few minor cosmetic fixes, and a few bug fixes in
  427.    RAPMAIL (now v0.5)
  428.    The bugfixes include eliminating tossing those silly arcmail packets
  429.    created by your front end mailer back into your BBS mail<G>. Also
  430.    fixed some problems RAPMAIL had finding users with netmail. Now
  431.    tosses netmail to the right user account instead of the first one
  432.    with a partial match to the name (oooops!)
  433.    In RAPTOR itself changed the YES/NO prompts to a toggleable type
  434.    prompt. Hit a key to toggle the hilight from yes to no then hit
  435.    enter...
  436.  
  437. ANSIBOXES
  438. ---------
  439.         Ansiboxes will draw a 3-D box around one line of text. This
  440.         option is selectable from the miscelaneous configuration menu.
  441.         At present there are three types (0= No box, 1= Blue Box, 2=
  442.         Gray Box) More colors to follow. Use of the boxes is accessible
  443.         to sysops using a new MCI code @I%string to print%.
  444.         This MCI is available in both files and messages(example title
  445.         lines for your bulletins) as well as in the string editor for
  446.         prompts etc.. You are restricted however to using only 76
  447.         characters in the 'string to print' The two '%' signs are
  448.         required in the MCI code...
  449.  
  450. Split screen Chat
  451. -----------------
  452.         Split screen chat now behaves exactly like the line style chat
  453.         as far as use of time goes. This is internal to RAPTOR so will
  454.         behave like this with ANY chat module written to use with
  455.         RAPTOR.
  456.  
  457. File Browsing
  458. -------------
  459.         The 'B' Browse Files command now displays one screen then the
  460.         prompt rather than a pause. This allows users to tag after each
  461.         screen is displayed. This method is preferable to the 'L' List
  462.         files command. We suggest eliminating the default List Files and
  463.         renaming the Browse command to List. This seems to make it
  464.         easier for the users...
  465.  
  466.  
  467. 1-4-96
  468. ------
  469. INTERNODE PAGING and TELECONFERENCE
  470. ====================================
  471.  
  472. 1) New Menu Commands-
  473.     'OD'- Page a user on another node from the menu prompt. Do not need
  474.     to be in teleconference area to use this. No Mstring.
  475.     'OT'- Enter teleconference area to access conference rooms, group
  476.     chat etc.
  477.     'OW' -Who's on line listing. Shows activity for ANY nodes which have
  478.     been active.
  479.  
  480. 2) New configuration options-
  481.    (Key sequences are from WFC)
  482.    'PB5'- Sets the path where the internode chat files will be located.
  483.    At installation this path  defaults to 'LOGS'(old 'trap'). For
  484.    optimum speed this could be set to a RAMDrive
  485.    'PEM'- If on enables checking for internode messages. If off no
  486.    internode commands are available and no internode files are created.
  487.    Single node systems should NOT enable the teleconference system.
  488.  
  489. 3) Commands from teleconference submenu
  490.    '/J [Conference #]' - Join conference room #
  491.    '/A [Username] {actionword]'- Transmits action word string inserting
  492.    your name and Username in appropriate places.(Not yet implemented)
  493.    '/P [Username] [Message]'- Sends page message to Username wherever
  494.    they are in the BBS, provided they are available for page.
  495.    '/ [Username] [Message]'-Whispers a message to Username. In other
  496.    words noone else in the conference room will see this message.
  497.    '/$' - Displays users information.
  498.    '/#' - Who's on line.
  499.    '/X' or 'X' - Exits Teleconference area.
  500.    '/?' or '?' - Displays Teleconference help screen.
  501.  
  502.  
  503. It is important to realize that teleconferenceing is a very disk intensive
  504. operation and that signifigant speed improvements can be realised by
  505. using a ramdrive for the teleconference file path.  The Teleconference
  506. files are relatively small, so the Ramdrive would not have to be very
  507. big. 1-2 K per node would be more than sufficient.( The files are
  508. actually 414 bytes each, but the 1 to 2 k would allow for small files to
  509. be attached.) Right now there is no way for a user to toggle chat
  510. availability, that will be coming shortly.
  511.  
  512.  
  513. OS/2 NOTES!!!!!
  514. -----------------
  515. When running under OS/2 it is necessary to DELETE the VOLUME ID from
  516. your hard drive. The reason is a quirk in OS/2 which returns the volume
  517. label as a filename. During the logon procedure RAPTOR checks to confirm
  518. that all files in the temp dirs have been deleted from the previous
  519. caller. If OS/2 Returns the Volume Label RAPTOR will try to delete a
  520. file with that same name, since the file doesn't exist a very sudden and
  521. unpleasant crash will result. We are looking into ways to eliminate this
  522. problem completely, however we offer this idea as a temporary solution.
  523. Besides.... what good does the bloody Disk Label do anyway!?!?!?!?!?!?!
  524.  
  525. Passing actual speeds
  526. ---------------------
  527. Two new MCI codes to pass the actual connect speed to either a door on
  528. the command line or to a protocol ( example CEXYZ allows passing both
  529. the locked port rate and the actual connect speed, also some CD rom
  530. doors need the actual speed to calculate correct download limits.) The
  531. actual speed is passed to either a door or an external protocol by using
  532. the %S MCI code. Example: 14,400 bps modem with a locked port at 19,200.
  533. For a 2400 baud caller %B will pass the value 19200 while %S will pass
  534. the value 2400).
  535.  
  536. 2-7-96
  537. -------
  538. OK if you've made it to this point, be certain that you now(if not
  539. before) read the README!!.1ST file. This contains some additions not
  540. discussed in this document. ( Now aren't you glad YOU aren't the doc
  541. coordinator<G>)
  542.  
  543. ================
  544. File Listings
  545. ================
  546. A lot of the recent activity has gone into cleaning up the file listing
  547. appearance, both for new scans and using the List/Browse option. First
  548. of all if you have any comments or suggestions on the looks of the
  549. display forward them to one of the development team.
  550. Version 8b4 introduces sysop selectable file list types. The three
  551. options are:
  552. Option #1
  553. ---------
  554. Num    Filename    Size   FilePts     Short Desc
  555.                                      Long desc
  556.                                      Long desc
  557.                                      .... for the length of the long
  558.                                      desc
  559.  
  560. Option #2
  561. ---------
  562. Num    Filename    Size   File Pts     Short Desc
  563.  
  564. You will notice option 2 has no long description and will display 15
  565. files per screen.
  566.  
  567. Option #3
  568. ---------
  569. Num    Filename    # of DL's    U/L Date    Uploader
  570. Size       Fiel pts                Short Desc
  571.                                 Long desc
  572.                                 Long desc
  573.                                 ..... till the end of long desc
  574.  
  575. If no option has been selected in the system config ( From the WFC
  576. screen P,F,L for the file list style option) then option #3 will become
  577. the default. This can be changed at any time.
  578.  
  579. Again any suggestions for improvements in this area are more than
  580. welcome, and all will be considered.
  581.  
  582. =================
  583. 2-11-96
  584. =================
  585. Configurable netmail path
  586. -------------------------
  587. Begining with the .8b4 release the path for your netmail *.MSG directory
  588. is now configurable. You MUST fill in this path and run RAPMAIL.EXE
  589. Dated after 2-10-96(v.7b) for this to be used. The path is set from the
  590. network configuration (from the WFC P,I ) as option J. This should be
  591. the full path to your netmail directory.
  592.  
  593. ==================
  594. 2-20-96
  595. ==================
  596. Messsage base display files
  597. ---------------------------
  598. Raptor can display a custom RIP/ANSI/MSG file when the user READS
  599. messages in a message base. Simply create a file named MDF#####.* where
  600. the ##### is the number of the message where this file should be
  601. displayed (NOTE:Message base #1 would be MDF1.ANS for an ansi file. Do
  602. NOT pad out the number with 0's) and place it in the MISC (AFILES)
  603. directory. Thios file will be displayed when the user selects the READ
  604. option, it will not display during scans of the message areas.
  605.  
  606. ================
  607. 3-7-96
  608. ===============
  609. OK several things finalized today, simple things first...
  610.  
  611. Total system callers
  612. --------------------
  613. You can now edit the total number of system callers from the
  614. configuration editor in the Miscellaneous Configuration Area
  615. (from the WFC select 'P' then 'H'). Use this however you want <BEG>.
  616. This was primarily designed in the event that the STATUS.DAT got
  617. corrupted and had to be replaced.
  618.  
  619. Personal Message Scan
  620. ---------------------
  621. RAPTOR will now scan the public message areas for messages addressed to
  622. the user. This is similar to the Newscan in that it can be global or
  623. single base, can scan across all conferences, and uses the same MString
  624. as the newscan. The difference is the user is prompted as to whether
  625. RAPTOR should update their Hi-Read message pointers after the scan.
  626. Selecting NO at this prompt will NOT update the pointers allowing the
  627. user to come back and read all new messages at a later time.
  628. Implementation can be done two ways. A new Menu Command has been added
  629. 'MY' which will take the user to the personal newscan. Also a toggle is
  630. provided to prompt the user during logon to scan for new personal
  631. messages. The menu command will use an MString if provided, however the
  632. logon sequence will behave as if no MString was found, prompting the
  633. user if it should be global.
  634.  
  635. Menutitle MCI codes
  636. -------------------
  637. Two new MCI codes are provided which contain the menu title lines 1 and
  638. 2.
  639.     %] - returns title line 1 of the current menu
  640.     %[ - returns title line 2 of the current menu
  641. These are primarily designed to allow creting ansi prompts for menus
  642. which can be displayed using the %J@filename@ MCI code.
  643.  
  644. Multi - menu configuration
  645. ---------------------------
  646. ***********************************************
  647. BEFORE PROCEEDING, BE CERTAIN TO BACKUP YOUR STATUS.DAT AND STRING.DAT
  648. FILES!!!!!!!  IT IS ENTIRLEY POSSIBLE TO DESTROY THE DEFAULT PATHS
  649. STORED IN STATUS.DAT. IF YOU GET AN ERROR MESSAGE THAT PATHS ARE MISSING
  650. SIMPLY REINSTALL YOUR BACKUP OF STATUS.DAT AND TRY AGAIN
  651. ************************************************
  652.  
  653. OK well since we haven't documented the language file and string editor
  654. yet we'll start from the very beginning. RAPTOR's string editor will
  655. also create a language.dat file in your DATA(GFILES) directory. If this
  656. file is present, it will create an on the fly menu prompting the user to
  657. select a language. Also contained in this file is a number corresponding
  658. to the paths to be used by RAPTOR for the *.MNU menu command files as
  659. well as the path for the RIP/ANSI/MSG display files for this language.
  660. OK now what does this all mean? It means simply you can create a
  661. language with the look and feel of any other BBS software, right down to
  662. duplicating the command keys a user would enter if using that software.
  663. Let's say there is a BBS package called PussyCat, and you want to
  664. duplicate it's looks (WHY?? I dunno!). But you would create a language
  665. which duplicated the prompt strings for that software, then you could
  666. create a set of RIP/ANSI screens to duplicate the looks of that
  667. software, and then even create a set of *.MNU files to change the normal
  668. RAPTOR command keys for anyone who chooses that Language!
  669.  
  670.  OK now to rough out the ideas here. These are the basic rules...
  671.  1) If there is a language.dat file you MUST create a MEUNCFG.DAT file
  672.  by using the Alternate Path Editor (from the WFC select P then J). This
  673.  will prompt you for the set to configure, and prompt you for the paths
  674.  for the *.MNU files and the RIP/ANSI files.
  675.  2) Several languages can share the SAME Paths for MNU and display
  676.  files, even if the langauge files themselves are different.
  677.  The menu set is selected in the string editor.
  678.  3) You should ALWAYS make menu set 1 the default MENUS path and default
  679.  MISC path (or what you specified during RAPINIT). Use these files
  680.  with your 'default' language file.
  681.  4) The MENUS dir and the MISC dir for each language must BOTH exist and
  682.  have the appropriate files in them if you want to use either one. In
  683.  other words if you want to use the MNU files for all languages, but
  684.  different RIP/ANSI/MSG screens you must copy the MNU files to the
  685.  appropriate MENU directory for that set. Note though, that the MENUS path
  686.  can be set to the default menu path. Just be certain that the MENUS
  687.  path you setup does in fact exist.
  688.  5) The max number of Languages is 20 as well as the max number of
  689.  menuset directories. Make sure the directories shown in the config
  690.  (from the WFC P then B ) are used also as the directories for the #1
  691.  menuset.
  692.  
  693. Hopefully by now you have the BASIC idea, but to really appreciate the
  694. power of this sytem you will need to play with it. A couple things to
  695. think about..
  696. 1) You don't have to start from 'scratch'. Copy your original MENUS and
  697. MISC files to the new ones and modify them.
  698. 2) Create custom menu prompts using the same filename and the %J MCI code
  699. with the two new Menu title MCI's. This allows you to make the prompts
  700. all different.
  701. 3) I would suggest creating directory names MENU1, MENU2 , MISC1, MISC2
  702. etc. just to make it simpler on you to maintain these directories.
  703.  
  704. As you can see this allows almost complete configuration of not only the
  705. look but the feel of your RAPTOR BBS! These changes require some getting
  706. used to. We suggest creating one language, and pointing it to the #1
  707. menuset. This will allow you to configure all the strings for this
  708. language. After the strings are done and your menus and display files
  709. are finished, use the string editor to change the menu set used by that
  710. language to the correct one.
  711.  
  712. Editing menus-
  713.   If you are using multiple menu sets, RAPTOR will prompt you for the
  714.   menuset to edit when you enter the menu editor. If the paths specified
  715.   for the MENU and MISC directories for this menu set do not exist,
  716.   RAPTOR will attempt to create them. If the menus already exist then
  717.   RAPTOR will load the MNU files from the MENU dir for that language. Be
  718.   aware that menu sets are referred to by NUMBER not the language name
  719.   since several languages can all share the same menu set directories.
  720.   It is possible to have 20 languages, and only one MISC and MENUS dir,
  721.   with all languages using the same menu set.
  722.  
  723. Whew! Hopefully this is enough to get you started. As a precuation
  724.  
  725.  
  726. *******
  727. BACKUP YOUR STATUS.DAT!!!!!  BEFORE YOU BEGIN TO EDIT THE MENU
  728. SETS!!!!!!
  729. *******
  730.  
  731. ########################
  732.  
  733. HOT TIP!!!
  734.  
  735. ########################
  736. In the message and file newscan routines you can now play a couple games
  737. with RAPTOR!. To achieve the 'classic' TG/RG scrolling scan messages use
  738. these lines as the newscan began and newscan done strings in the string
  739. editor.
  740.  
  741. NEWSCAN BEGAN - [Newscan - %Y ] %W messages began%M
  742. NEWSCAN DONE - [Newscan - %Y ]  DONE! %M %M
  743.  
  744. notice the %M MCI Codes ( carriage return) and particularly the double
  745. %M on the done string.
  746.  
  747. To have RAPTOR NOT scroll the display, but simply overwrite the previous
  748. message on the same line use these lines.
  749. NEWSCAN BEGAN - Scanning - %Y - %W messages
  750. NEWSCAN DONE -
  751.  
  752. Notice the DONE string is left BLANK! ( no space, just hit enter when
  753. the cursor is in the first position of the empty input window) and that
  754. the BEGAN string does NOT have the %M MCI code.
  755. ###########################
  756.  
  757. Qoute Headers
  758. --------------
  759.   RAPTOR now adds quote header lines in the stringeditor. Information
  760.   from the message being quoted can be passed in the following MCI's.
  761.   These are valid ONLY in the 2 quote header lines. The quote headers
  762.   are used in public posts, and if the string is left blank for either
  763.   line it is not used...
  764.   ~A = From who
  765.   ~B = To who
  766.   ~C = Message date and time
  767.   ~D = Message title
  768. ---------------------------------------------------------------------------
  769.  
  770. =============
  771. 3-23-96  Version 9b2
  772. =============
  773. Internal Call back verifier
  774. ---------------------------
  775.  
  776. RAPTOR now includes an internal call back verifier.  When RAPTOR
  777. validates a user by Call back it will set their account to the levels
  778. you specify in the call back validation level(from the WFC P,G).
  779.    ---------------
  780.    Configuring CBV
  781.    ---------------
  782.    RAPTOR CBV system allows the SYSOP to configure the way the CBV
  783.    functions under several conditions. In the CBV configuration section
  784.    (from the WFC P,S) the following options are available.
  785.  
  786.    Call back new users- Will force all new users who meet other
  787.    restrictions to be sent through the call back verifier. The other way
  788.    to validate users is to set the verifier up through the menu system
  789.    using the 'OE' command keys.
  790.  
  791.    Call back local only- This will call back local phone numbers in the
  792.    three digit exchange areas you specify in CALLBACK.DAT, located in
  793.    your RAPTOR/DATA(GFILES) Directory. This is an ascii text file which
  794.    can be created with DOS edit or any other text editor. Each three
  795.    digit exchange number is entered on it's own line in this file.
  796.  
  797.    Call back my area code- this will call back users in all exchanges
  798.    provided the area code field of the users number matches the are code
  799.    of the BBS phone number field (from WFC screen P,B). This will ignore
  800.    any entries in the CALLBACK.DAT file.
  801.  
  802.    Call back all (LD)- This will call all users back in ANY area code,
  803.    appending a '1' in front of any numbers not in your AREA CODE.
  804.  
  805.    Hang up after callback- This will disconect the user after they have
  806.    been validated, showing them a message that they have in fact been
  807.    validated and asking them to call the BBS back.
  808.  
  809.  
  810. Controlling the CBV from the local keyboard
  811. --------------------------------------------
  812. The ESCAPE Key will abort ALL attempts to validate the current user.
  813. The SPACEBAR will abort the current dial attempt to validate the user.
  814. Normally the CBV will make 3 attempts to contact the user. Once the user
  815. answers the phone by typing ATA when they see ring on their screen and
  816. the modems negotiate a connect, the user will have three attempts to
  817. enter the correct password. If the password is correct they will have
  818. three attempts to enter their correct phone number. If either of these
  819. fails the call is terminated.
  820. All CBV activity is appended to the sysop log showing both successes and
  821. failures. Also the users name, handle, password, phone and city are
  822. appended to the log as a new user enters their information. This will
  823. allow you to check for any attempts to enter bogus info or use things
  824. like the %PW lockup routines that work in other software<G>
  825.  
  826. The CBV includes default text that is displayed to the user before he is
  827. called back and upon successful connection to his terminal This text may
  828. be replaced by RIP/ANSI/MSG files called CBV1.??? and CBV2.???. CBV1 is
  829. diplayed to the user just before disconnect when RAPTOR is preparing to
  830. call them back, and CBV2 is diplayed immediately after successful
  831. connect. RAPTOR uses the ANSI password and phone prompts from the string
  832. editor to prompt the user for their info.
  833.  
  834. The CBV also stamps the date the user was validted in the user record
  835. date validated field.
  836.  
  837.  
  838. -----------------------
  839. User Expiration
  840. -----------------------
  841. RAPTOR also includes a user validation expiration function. Anytime you
  842. validate a user (ALT-V on-line or '*' from the user editor or via CBV)
  843. the current date is entered in the Date validated field of the user
  844. record. There is also a field in the record for the number of days until
  845. the users validation expires. This is normally set to zero, and is set
  846. by the sysop for the number of days until this user's validation level expires.
  847. The third field used in the expiration routine is the level to expire
  848. to.
  849. Level 1 = New user level
  850. Level 2 = Call back validated level
  851. Level 3 = Validated user ( ALT-V or '*') this option is for any users
  852. you manually validate above one of three defined levels. Selecting the
  853. date validated field within the user editor will stamp the users account
  854. with the current date.
  855.  
  856. When the user logs on if their days to expiration is set to anything
  857. other than zero, RAPTOR will compare their validation date with the
  858. current date and if the difference is greater than days to expire then
  859. their account will be reset to the Level to Expire to.
  860.  
  861. ----------------
  862. Newuser Letter
  863. ----------------
  864.  
  865. A text file (NEWLETR.MSG) located in the MISC(AFILES) directory will be
  866. shown to all first time callers as an Email message. Use the %H MCI code
  867. to pass the user's name to the message. This mail will be automatically
  868. deleted when the user hits RETURN, Q, or D at the prompt. (These are the
  869. only valid inputs accepted at the prompt); This file can contain Pipe
  870. color codes, and MCIs. The name used in the from field for this letter
  871. comes from the first line of NEWLETR.MSG. The actual message body text
  872. begins with line 2. This allows the sysop to send the New User Letter
  873. with either his real name or handle.
  874. ------------------------------------------------------------------------
  875. ----------------
  876. File Lists
  877. ----------------
  878. Improved the logic of the 'List' Files (Browse) command so that RAPTOR
  879. checks the length of the long description of the following file. If the
  880. complete description cannot be displayed on the current screen the
  881. prompt will be shown and the file shown on the next screen. This should
  882. eliminate the occasional scrolling problem and the truncated file
  883. descriptions in the .8beta series. Also added a Yes/No question for the
  884. user to select whether they want to see the long description.... that
  885. and a few cosmetic improvements improve the looks and flexibilty of the
  886. file displays...
  887. ----------------------------------------------------------------------------
  888. RAPTOR 9b3 05-05-96
  889. ____________
  890. Mass Uploads
  891. ------------
  892. RAPTOR now includes an option to 'Mass upload' files. When using the /U
  893. upload all files, you will be prompted whether to mass upload files. A
  894. mass upload will not prompt you for descriptions for the file. It will
  895. upload a blank short description, and use the FILE_ID.DIZ for the long
  896. description if it exists. If no FILE_ID.DIZ exists then RAPTOR will
  897. insert a description line stating no description is available.
  898.  
  899. -----------
  900. CD-ROM Uploads
  901. -----------
  902. If a file base area is marked with the 'C'(CDROM) flag, RAPTOR will
  903. search the download path for a text description file ( such as
  904. FILES.BBS) that is specified in the FILE configuration( from the WFC
  905. 'F') option 'M' is the file name or the description file, and option 'N'
  906. is the position in the description line where the actual description
  907. text will start. When searching for the matching filename, RAPTOR
  908. assumes the filename starts at character 0 of the line. The description
  909. will be entered for the short description, and if a FILE_ID.DIZ is found
  910. this will be used for the long description. If the description file for
  911. the area is not found in the same directory as the downloadable files,
  912. the path to the description may be placed in the Upload path of the file
  913. base configuration. This will prevent you from having a hard drive
  914. upload area for this CD area.
  915.  
  916. ----------------
  917. Upload event
  918. ---------------
  919. Running BBS -U will do a mass upload for all file directories. This can
  920. be convenient for uploading files from a network file distribution area.
  921. This is an automated event which will upload all files in all
  922. directories, using the FILE_ID.DIZ for the extended description, and a
  923. blank short description.
  924.  
  925. ------------------
  926. Old user deletion
  927. ------------------
  928. Running BBS -D will dlete users who have been inactive for a specified
  929. number of days. The number of days is configured in the main
  930. configuration(from the WFC P, D, option T) This will delete the users
  931. account, all mail to or from this user, and any short messages for this
  932. user. It will not pack the user base, and will honor accounts with the
  933. DO Not delete Flag set.
  934.  
  935.  
  936. ================
  937. RAPTOR 9b4
  938. ================
  939. 6-16-96
  940.  
  941. Final Beta release
  942. ------------------
  943.  
  944. Current plans call for the release of 9b4 to be the final public BETA of
  945. RAPTOR before the release of the full 1.0 version. It is with deep
  946. regret that we have accepted the resignation of Michael Keefe of
  947. Tombstone Software as senior programmer for the development team. Mike
  948. has made many signifigant contributions to RAPTOR in the last 18 months,
  949. not only in code but also in ideas. The upside of this situation is it
  950. allows me a bit more flexibility in issuing bugfixes, since we don't
  951. have to maintain two current versions of the code 500 miles apart<G>.
  952. Hopefully when Mike has more time he will be able to return to the
  953. development team. In the meantime I expect we will se several third
  954. party utilities for RAPTOR released by Tombstone ( hint hint Mike!).
  955. Current commitments to work and  college have just put too much strain
  956. on Mike's time.
  957.  
  958. The prerelease special price of $30.00 will expire July 31, 1996. Any
  959. orders for RAPTOR at this special 50% off price must be postmarked no
  960. later than midnight July 31, 1996. BEAT KEY evaluation codes will no
  961. longer be valid after the release of 1.0. The QWK functions will not be
  962. fully implemented on systems running the BETA KEY. QWK pkts will be
  963. limited to 25 messages on unregistered sites and sites running BEAT KEY
  964. registrations.
  965.  
  966. RAPMAIL
  967. -------
  968. RAPMAIL now marks netmail as RECEIVED when it is processed.
  969.  
  970. Messages
  971. --------
  972. Color codes in messsages are now added when the messages are read as
  973. opposed to when they were written or imported by RAPMAIL. This allows
  974. ANSI files to be displayed in the message body without those annoying
  975. heart-code colors buried in the first line...
  976.  
  977. QWK Mail
  978. --------
  979. The QWK Mail functions are now in place and functional. Total messages
  980. per packet are limited to 40 messages in this version. The 9b4r version
  981. will be released to registered sysops only and has unlimited QWK packet
  982. size. Currently the WELCOM/GOODBYE screen options and the New message
  983. file lists are not functional, these will be included in the 1.0
  984. release. Configuration is pretty self explnantory. Here are the menu
  985. commands which control the QWK areas.
  986. QO - Configure the users QWK options
  987.      Default archiver
  988.      Pack messages sent by the user
  989.      Include WELCOME/GOODBYE screens ( nonfunctioanl in this release)
  990.      Include new files list ( nonfunctional in this release)
  991.      Delete E-Mail after it is downloaded
  992.      Mark Public messages as read after downloding
  993. QS - Select message bases to include in QWK scan. This can be different
  994.      from the areas scanned while the user is reading on-line.
  995. QD - Download a QWK packet. This scans the selected messsage bases,
  996.      packs the messages, and downloads the packets to the user. ( For
  997.      local packets you must drop to DOS and move the packet from the
  998.      node dropfile path to a directory for reading.
  999. QU - Upolad a REP packet. This uploads the user's REP packet, unpacks it
  1000.      and imports the messages to the message bases. For a local REP
  1001.      before using this caommand move the REP packet into the node drop
  1002.      file path. Netmail messages are not currently supported in .REP
  1003.      packets.
  1004. Finally you must insert an 8 characetr BBSID name in the miscellaneous
  1005. configuration option (P,H,I from the WFC) This is the 8 characetr which
  1006. will be used for the filename for QWK/REP packets, as well as the BBSid
  1007. to be used by the QWK reader and RAPTOR's .REP processor to validate the
  1008. origin/destination of the packets. This field does not need to be 8
  1009. characters. The 8 character limit is the max limit. For example here at
  1010. the Eagle's Lair our BBSID is LAIR, thus producing LAIR.QWK and
  1011. LAIR.REP.
  1012.  
  1013. ------------
  1014. 06-20-96
  1015. ------------
  1016. Added integrity check to files attached to EMail. This will use the
  1017. integrity check command line from the archiver setup for the type of
  1018. archive used in the attached file. If the integrity test command line is
  1019. set to use THDPRO or another virus scan program then the file will be
  1020. scanned. If the file is found to be beinfected the virus scanning
  1021. software ( again we recommend THDPro to control the scan) should be
  1022. setup to move infected files to another directory. RAPTOR will NOT
  1023. control this. Your virus scanning software MUST be able to handle infected
  1024. files on it's own.....
  1025.